#AI 智能巡查功能指南

AI 智能巡查是基于 Claude Code Agent SDK 的日志自动化分析功能。系统通过 AI 读取服务器日志文件，自动识别 ERROR、WARN 等异常信息，生成结构化的巡检报告，帮助运维人员快速定位问题。

#整体流程

flowchart LR
    A[创建巡检任务] --> B[配置日志目录和时间范围]
    B --> C[执行巡检]
    C --> D[Claude Code 分析日志]
    D --> E[生成 Markdown 报告]

#前置条件

使用 AI 智能巡查功能前，需要完成以下准备工作：

1. 安装 Claude Code CLI：参考 Claude Code 正确的安装方式 完成安装和供应商配置
2. 开通 AI 套餐：确保已开通包含 AI 服务套餐
3. 配置模型供应商：通过 CC-Switch 或环境变量配置好可用的 API 中转服务

#功能背景

传统的日志巡查依赖运维人员手动登录服务器，通过 grep、tail 等命令逐一排查日志文件，存在以下痛点：

• 日志量大，人工排查耗时且容易遗漏关键信息
• 需要熟悉每个服务的日志格式和存储路径
• 异常关联分析困难，难以从分散的日志中还原问题全貌
• 缺乏标准化的巡检报告，团队协作效率低

AI 智能巡查通过 Claude Code 驱动 AI 自主分析日志文件，自动完成文件扫描、异常提取、趋势分析和报告生成，将原本数小时的人工巡查缩短到分钟级别。

flowchart LR
    A[PIGX 平台] --> B[Claude Code]
    B --> C[读取日志文件]
    C --> D[AI 分析异常]
    D --> E[生成巡检报告]
    E --> F[SSE 流式返回]

#使用指南

#创建巡检任务

进入 AI 智能巡查 页面，点击「新增」按钮创建巡检任务。

任务配置字段说明：

时间范围支持以下预设选项：

• 最近1小时：分析过去60分钟内的日志
• 今天：分析当天零点至当前时间的日志
• 昨天：分析前一天完整的日志
• 最近3天 / 最近7天：分析对应天数内的日志
• 自定义：通过日期时间选择器指定精确的起止时间

#执行巡检

在任务列表中点击「执行」按钮，打开实时巡检弹窗。点击「开始巡检」后，系统通过 SSE 连接实时展示巡检过程。

巡检界面分为三个区域：

• 顶部信息栏：显示日志目录、时间范围、当前状态和进度条
• 左侧执行日志：实时展示 AI 的工具调用过程，包括文件读取、内容搜索、命令执行等操作
• 右侧巡检报告：以 Markdown 格式流式输出分析报告

#查看历史报告

点击任务列表中的「报告」按钮，打开全屏抽屉查看历史巡检记录。

• 左侧：按时间倒序展示所有执行记录，每条记录显示执行时间、成功/失败状态和耗时
• 右侧：选中某条记录后展示完整的 Markdown 巡检报告

支持单条删除和批量删除执行记录。

#巡检报告内容

AI 生成的巡检报告通常包含以下内容：